String Oluşturucular

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

String sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

String(Char*)	String sınıfının yeni bir örneğini, belirtilen bir Unicode karakter dizisi işaretçisi tarafından belirtilen değere başlatır.
String(Char[])	belirtilen karakter dizisinde belirtilen Unicode karakterlerine String sınıfının yeni bir örneğini başlatır.
String(ReadOnlySpan<Char>)	String sınıfının yeni bir örneğini, belirtilen salt okunur yayılma alanında belirtilen Unicode karakterlerine başlatır.
String(SByte*)	String sınıfının yeni bir örneğini, 8 bit imzalı tamsayılar dizisinin işaretçisi tarafından gösterilen değere başlatır.
String(Char, Int32)	String sınıfının yeni bir örneğini, belirtilen sayıda yinelenen belirtilen Unicode karakteriyle belirtilen değere başlatır.
String(Char*, Int32, Int32)	String sınıfının yeni bir örneğini, belirtilen bir unicode karakter dizisi işaretçisi tarafından belirtilen değere, bu dizi içinde bir başlangıç karakteri konumuna ve bir uzunluğa başlatır.
String(Char[], Int32, Int32)	String sınıfının yeni bir örneğini Unicode karakter dizisi, bu dizi içinde bir başlangıç karakteri konumu ve bir uzunluk ile belirtilen değere başlatır.
String(SByte*, Int32, Int32)	String sınıfının yeni bir örneğini, 8 bit imzalı tamsayılar dizisinin belirtilen işaretçisi tarafından belirtilen değere, bu dizi içinde başlangıç konumuna ve bir uzunluğa başlatır.
String(SByte*, Int32, Int32, Encoding)	String sınıfının yeni bir örneğini, 8 bit imzalı tamsayılar dizisi, bu dizi içinde başlangıç konumu, uzunluk ve Encoding nesnesi için belirtilen işaretçi tarafından belirtilen değere başlatır.

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. Dize oluşturucuiçin ek API açıklamaları.

String(Char*)

Kaynak:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

String sınıfının yeni bir örneğini, belirtilen bir Unicode karakter dizisi işaretçisi tarafından belirtilen değere başlatır.

public:
 String(char* value);

[System.CLSCompliant(false)]
public String (char* value);

[<System.CLSCompliant(false)>]
new string : nativeptr<char> -> string

Parametreler

value

Char*

Null olarak sonlandırılan Unicode karakter dizisinin işaretçisi.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

Geçerli işlemin tüm adreslenen karakterlere okuma erişimi yok.

ArgumentException

value geçersiz unicode karakter içeren bir diziyi veya value 64000'den küçük bir adresi belirtir.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.

String(Char[])

Kaynak:

String.cs

belirtilen karakter dizisinde belirtilen Unicode karakterlerine String sınıfının yeni bir örneğini başlatır.

public:
 String(cli::array <char> ^ value);

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

Parametreler

value

Char[]

Unicode karakter dizisi.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.

String(ReadOnlySpan<Char>)

Kaynak:

String.cs

String sınıfının yeni bir örneğini, belirtilen salt okunur yayılma alanında belirtilen Unicode karakterlerine başlatır.

public:
 String(ReadOnlySpan<char> value);

public String (ReadOnlySpan<char> value);

new string : ReadOnlySpan<char> -> string

Public Sub New (value As ReadOnlySpan(Of Char))

Parametreler

value

ReadOnlySpan<Char>

Unicode karakterlerinin salt okunur yayılma alanı.

String(SByte*)

Kaynak:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

String sınıfının yeni bir örneğini, 8 bit imzalı tamsayılar dizisinin işaretçisi tarafından gösterilen değere başlatır.

public:
 String(System::SByte* value);

[System.CLSCompliant(false)]
public String (sbyte* value);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string

Parametreler

value

SByte*

8 bit imzalı tamsayılardan oluşan null olarak sonlandırılan bir diziye yönelik bir işaretçi. Tamsayılar, Windows'ta geçerli sistem kodu sayfa kodlaması (CP_ACP olarak adlandırılır) ve Windows olmayanlarda UTF-8 kodlaması olarak yorumlanır.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

value null.

ArgumentException

yeni bir String örneği, value ANSI'de kodlanmış olduğu varsayılarak valuekullanılarak başlatılamadı.

ArgumentOutOfRangeException

başlatacak yeni dizenin uzunluğu, valuenull sonlandırma karakteri tarafından belirlenir, ayrılamayacak kadar büyük.

AccessViolationException

value geçersiz bir adres belirtir.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.

String(Char, Int32)

Kaynak:

String.cs

String sınıfının yeni bir örneğini, belirtilen sayıda yinelenen belirtilen Unicode karakteriyle belirtilen değere başlatır.

public:
 String(char c, int count);

public String (char c, int count);

new string : char * int -> string

Public Sub New (c As Char, count As Integer)

Parametreler

c

Char

Unicode karakteri.

count

Int32

c gerçekleşme sayısı.

Özel durumlar

ArgumentOutOfRangeException

count sıfırdan küçüktür.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.

String(Char*, Int32, Int32)

Kaynak:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

String sınıfının yeni bir örneğini, belirtilen bir unicode karakter dizisi işaretçisi tarafından belirtilen değere, bu dizi içinde bir başlangıç karakteri konumuna ve bir uzunluğa başlatır.

public:
 String(char* value, int startIndex, int length);

[System.CLSCompliant(false)]
public String (char* value, int startIndex, int length);

[<System.CLSCompliant(false)>]
new string : nativeptr<char> * int * int -> string

Parametreler

value

Char*

Unicode karakter dizisi işaretçisi.

startIndex

Int32

valueiçindeki başlangıç konumu.

length

Int32

kullanılacak value içindeki karakter sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

startIndex veya length sıfırdan küçüktür, value + startIndex işaretçi taşmasına neden olur veya geçerli işlemin tüm adreslenen karakterlere okuma erişimi yoktur.

ArgumentException

value geçersiz unicode karakter içeren bir diziyi veya value + startIndex 64000'den küçük bir adresi belirtir.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.

String(Char[], Int32, Int32)

Kaynak:

String.cs

String sınıfının yeni bir örneğini Unicode karakter dizisi, bu dizi içinde bir başlangıç karakteri konumu ve bir uzunluk ile belirtilen değere başlatır.

public:
 String(cli::array <char> ^ value, int startIndex, int length);

public String (char[] value, int startIndex, int length);

new string : char[] * int * int -> string

Public Sub New (value As Char(), startIndex As Integer, length As Integer)

Parametreler

value

Char[]

Unicode karakter dizisi.

startIndex

Int32

valueiçindeki başlangıç konumu.

length

Int32

kullanılacak value içindeki karakter sayısı.

Özel durumlar

ArgumentNullException

value null.

ArgumentOutOfRangeException

startIndex veya length sıfırdan küçüktür.

-veya-

startIndex ve length toplamı, valueöğe sayısından büyüktür.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.

String(SByte*, Int32, Int32)

Kaynak:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

String sınıfının yeni bir örneğini, 8 bit imzalı tamsayılar dizisinin belirtilen işaretçisi tarafından belirtilen değere, bu dizi içinde başlangıç konumuna ve bir uzunluğa başlatır.

public:
 String(System::SByte* value, int startIndex, int length);

[System.CLSCompliant(false)]
public String (sbyte* value, int startIndex, int length);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int -> string

Parametreler

value

SByte*

8 bit imzalı tamsayılardan oluşan bir diziye yönelik bir işaretçi. Tamsayılar, Windows'ta geçerli sistem kodu sayfa kodlaması (CP_ACP olarak adlandırılır) ve Windows olmayanlarda UTF-8 kodlaması olarak yorumlanır.

startIndex

Int32

valueiçindeki başlangıç konumu.

length

Int32

kullanılacak value içindeki karakter sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

value null.

ArgumentOutOfRangeException

startIndex veya length sıfırdan küçüktür.

-veya-

value + startIndex tarafından belirtilen adres geçerli platform için çok büyük; diğer bir ifadeyle, adres hesaplaması taşmış.

-veya-

Başlatılabilir yeni dizenin uzunluğu ayrılamayacak kadar büyük.

ArgumentException

value + startIndex tarafından belirtilen adres 64 binden az.

-veya-

yeni bir String örneği, value ANSI'de kodlanmış olduğu varsayılarak valuekullanılarak başlatılamadı.

AccessViolationException

value, startIndexve length birlikte geçersiz bir adres belirtin.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.

String(SByte*, Int32, Int32, Encoding)

Kaynak:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

String sınıfının yeni bir örneğini, 8 bit imzalı tamsayılar dizisi, bu dizi içinde başlangıç konumu, uzunluk ve Encoding nesnesi için belirtilen işaretçi tarafından belirtilen değere başlatır.

public:
 String(System::SByte* value, int startIndex, int length, System::Text::Encoding ^ enc);

[System.CLSCompliant(false)]
public String (sbyte* value, int startIndex, int length, System.Text.Encoding enc);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int * System.Text.Encoding -> string

Parametreler

value

SByte*

8 bit imzalı tamsayılardan oluşan bir diziye yönelik bir işaretçi.

startIndex

Int32

valueiçindeki başlangıç konumu.

length

Int32

kullanılacak value içindeki karakter sayısı.

enc

Encoding

value tarafından başvurulan dizinin nasıl kodlandığını belirten nesne. enc nullise ANSI kodlaması varsayılır.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

value null.

ArgumentOutOfRangeException

startIndex veya length sıfırdan küçüktür.

-veya-

value + startIndex tarafından belirtilen adres geçerli platform için çok büyük; diğer bir ifadeyle, adres hesaplaması taşmış.

-veya-

Başlatılabilir yeni dizenin uzunluğu ayrılamayacak kadar büyük.

ArgumentException

value + startIndex tarafından belirtilen adres 64 binden az.

-veya-

yeni bir String örneği, valueenctarafından belirtildiği gibi kodlanmış olduğu varsayılarak valuekullanılarak başlatılamadı.

AccessViolationException

value, startIndexve length birlikte geçersiz bir adres belirtin.

Açıklamalar

Not

Bu ve diğer String oluşturucu aşırı yüklemeleriyle ilgili örnekler ve kapsamlı kullanım bilgileri için String oluşturucu özetini inceleyin.