Update Array.CreateInstance docs to mention language support of non-zero based arrays (#3338)

* Update Array's docs to mention language support

* Non-zero based arrays are not supported in all major languages (C#, VB, F# etc...). This commit adds a note to the System.Array.CreateInstance(System.Type,System.Int32[],System.Int32[]) to mention that not all languages support non-zero based arrays with a brief C# example.

#901

* Apply suggestions from code review

Co-Authored-By: Andy De George <[email protected]>

Co-authored-by: Jan Kotas <[email protected]>
Co-authored-by: Andy De George <[email protected]>

Author: 3 people

xml/System/Array.xml

@@ -2516,8 +2516,9 @@
 
  This method is an O(`n`) operation, where `n` is the product of all values in `lengths`.  
 
-   
-  
+> [!NOTE]
+> Not all languages support arrays with non-zero lower bounds, and therefore you may not be able to cast instances of non-zero based <xref:System.Array> to the language's array type. For example, you cannot cast a 1-dimensional integer array with the lower bound 6 to C#'s `int[]` type. This results in <xref:System.InvalidCastException> during runtime with the message "Unable to cast object of type 'System.Int32[*]' to type 'System.Int32[]'.", where the asterisk (*) means non-zero based index. However, you can cast zero based arrays of any rank created with <xref:System.Array.CreateInstance(System.Type,System.Int32[],System.Int32[])> to the language's array. For example, you can cast a 2-dimensional zero based integer array created with this method to C#'s `int[,]` type.
+
 ## Examples  
  The following code example shows how to create and initialize a multidimensional <xref:System.Array> with specified lower bounds.