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*)	Sınıfın String 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 sınıfın yeni bir örneğini String başlatır.
String(ReadOnlySpan<Char>)	Sınıfın String yeni bir örneğini, belirtilen salt okunur yayılma alanında belirtilen Unicode karakterlerine başlatır.
String(SByte*)	Sınıfının yeni bir örneğini String , 8 bit imzalı tamsayılar dizisi işaretçisi ile gösterilen değere başlatır.
String(Char, Int32)	Sınıfın String yeni bir örneğini belirtilen sayıda yinelenen belirtilen Unicode karakteriyle belirtilen değere başlatır.
String(Char*, Int32, Int32)	Sınıfın String 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)	Sınıfın String 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)	Sınıfın String yeni bir örneğini, 8 bit imzalı tamsayılardan oluşan bir diziye, bu dizi içinde bir başlangıç konumuna ve bir uzunluğa işaret eden belirtilen işaretçiyle belirtilen değere başlatır.
String(SByte*, Int32, Int32, Encoding)	Sınıfın String yeni bir örneğini 8 bit imzalı tamsayılar dizisi, bu dizi içinde başlangıç konumu, uzunluk ve Encoding nesnenin belirtilen işaretçisi tarafından belirtilen değere başlatır.

Açıklamalar

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

String(Char*)

Source:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

Sınıfın String 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 karakteri 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üklemeleri hakkında örnekler ve kapsamlı kullanım bilgileri için oluşturucu özetini String inceleyin.

String(Char[])

Source:

String.cs

Belirtilen karakter dizisinde belirtilen Unicode karakterlerine sınıfın yeni bir örneğini String 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 karakterler dizisi.

Açıklamalar

Not

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

String(ReadOnlySpan<Char>)

Source:

String.cs

Sınıfın String 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 karakterlerin salt okunur yayılma alanı.

String(SByte*)

Source:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

Sınıfının yeni bir örneğini String , 8 bit imzalı tamsayılar dizisi işaretçisi ile 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 geçerli sistem kodu sayfa kodlaması (yani tarafından Defaultbelirtilen kodlama) kullanılarak yorumlanır.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

value, null değeridir.

ArgumentException

YENI bir örneğiString, ANSI'de kodlanmış olduğu varsayılarak value kullanılarak valuebaşlatılamadı.

ArgumentOutOfRangeException

başlatacak yeni dizenin uzunluğu( null sonlandırma karakteri valuetarafı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üklemeleri hakkında örnekler ve kapsamlı kullanım bilgileri için oluşturucu özetini String inceleyin.

String(Char, Int32)

Source:

String.cs

Sınıfın String 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 karakter.

count

Int32

Kaç kez c gerçekleşir?

Özel durumlar

ArgumentOutOfRangeException

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

Açıklamalar

Not

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

String(Char*, Int32, Int32)

Source:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

Sınıfın String 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

içindeki valuebaşlangıç konumu.

length

Int32

kullanılacak karakter value sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

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

ArgumentException

value geçersiz Unicode karakteri 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üklemeleri hakkında örnekler ve kapsamlı kullanım bilgileri için oluşturucu özetini String inceleyin.

String(Char[], Int32, Int32)

Source:

String.cs

Sınıfın String 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 karakterler dizisi.

startIndex

Int32

içindeki valuebaşlangıç konumu.

length

Int32

kullanılacak karakter value sayısı.

Özel durumlar

ArgumentNullException

value, null değeridir.

ArgumentOutOfRangeException

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

-veya-

ve length değerinin startIndex toplamı, içindeki valueöğe sayısından büyüktür.

Açıklamalar

Not

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

String(SByte*, Int32, Int32)

Source:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

Sınıfın String yeni bir örneğini, 8 bit imzalı tamsayılardan oluşan bir diziye, bu dizi içinde bir başlangıç konumuna ve bir uzunluğa işaret eden belirtilen işaretçiyle belirtilen değere 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ılar dizisinin işaretçisi. Tamsayılar geçerli sistem kodu sayfa kodlaması (yani tarafından Defaultbelirtilen kodlama) kullanılarak yorumlanır.

startIndex

Int32

içindeki valuebaşlangıç konumu.

length

Int32

kullanılacak karakter value sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

value, null değeridir.

ArgumentOutOfRangeException

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

-veya-

tarafından value + startIndex belirtilen adres geçerli platform için çok büyük; yani adres hesaplaması taşmış.

-veya-

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

ArgumentException

tarafından value + startIndex belirtilen adres 64 BIN'den küçük.

-veya-

YENI bir örneğiString, ANSI'de kodlanmış olduğu varsayılarak value kullanılarak valuebaşlatılamadı.

AccessViolationException

value, startIndexve length toplu olarak geçersiz bir adres belirtin.

Açıklamalar

Not

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

String(SByte*, Int32, Int32, Encoding)

Source:

String.cs

Önemli

Bu API, CLS uyumlu değildir.

Sınıfın String yeni bir örneğini, 8 bit imzalı tamsayılar dizisinin belirtilen işaretçisi tarafından belirtilen değere, bu dizi içinde bir başlangıç konumuna, bir uzunluğa ve bir Encoding nesneye 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ılar dizisinin işaretçisi.

startIndex

Int32

içindeki valuebaşlangıç konumu.

length

Int32

kullanılacak karakter value sayısı.

enc

Encoding

tarafından value başvurulan dizinin nasıl kodlandığını belirten bir nesne. ise encnull, ANSI kodlaması varsayılır.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

value, null değeridir.

ArgumentOutOfRangeException

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

-veya-

tarafından value + startIndex belirtilen adres geçerli platform için çok büyük; yani adres hesaplaması taşmış.

-veya-

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

ArgumentException

tarafından value + startIndex belirtilen adres 64 BIN'den küçük.

-veya-

tarafından belirtilen encşekilde kodlanmış olduğu varsayılarak value yeni bir örneği String kullanılarak valuebaşlatılamadı.

AccessViolationException

value, startIndexve length toplu olarak 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 oluşturucu özetini String inceleyin.