String Constructor (array<Char[])

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the String class to the value indicated by an array of Unicode characters.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)


<SecuritySafeCriticalAttribute> _
Public Sub New ( _
    value As Char() _
public String(
    char[] value


  • value
    Type: array<System.Char[]
    An array of Unicode characters.


If value is nulla null reference (Nothing in Visual Basic) or contains no element, an Empty instance is initialized.


The following simple code example demonstrates how you can create an instance of the String class with this constructor.

' Unicode Mathematical operators
Dim charArr1() As Char = {ChrW(&H2200), ChrW(&H2202), _
                          ChrW(&H200F), ChrW(&H2205)}
Dim szMathSymbols As New String(charArr1)

' Unicode Letterlike Symbols
Dim charArr2() As Char = {ChrW(&H2111), ChrW(&H2118), _
                          ChrW(&H2122), ChrW(&H2126)}
Dim szLetterLike As New String(charArr2)

' Compare Strings - the result is false
outputBlock.Text &= "The strings are equal? " & _
        CStr(szMathSymbols.Equals(szLetterLike)) & vbCrLf
// Unicode Mathematical operators
char[] charArr1 = { '\u2200', '\u2202', '\u200F', '\u2205' };
String szMathSymbols = new String(charArr1);

// Unicode Letterlike Symbols
char[] charArr2 = { '\u2111', '\u2118', '\u2122', '\u2126' };
String szLetterLike = new String(charArr2);

// Compare Strings - the result is false
outputBlock.Text += "The Strings are equal? " +
    (String.Compare(szMathSymbols, szLetterLike) == 0 ? "true" : "false") + "\n";

Version Information


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0


For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.