String Konstruktor

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Menginisialisasi instans baru kelas String.

Overload

String(Char*)	Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array karakter Unicode.
String(Char[])	Menginisialisasi instans String baru kelas ke karakter Unicode yang ditunjukkan dalam array karakter yang ditentukan.
String(ReadOnlySpan<Char>)	Menginisialisasi instans String baru kelas ke karakter Unicode yang ditunjukkan dalam rentang baca-saja yang ditentukan.
String(SByte*)	Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk ke array bilangan bulat bertanda tangan 8-bit.
String(Char, Int32)	Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh karakter Unicode tertentu yang mengulangi beberapa kali tertentu.
String(Char*, Int32, Int32)	Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array karakter Unicode, posisi karakter awal dalam array tersebut, dan panjangnya.
String(Char[], Int32, Int32)	Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh array karakter Unicode, posisi karakter awal dalam array tersebut, dan panjangnya.
String(SByte*, Int32, Int32)	Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array bilangan bulat bertanda tangan 8-bit, posisi awal dalam array tersebut, dan panjangnya.
String(SByte*, Int32, Int32, Encoding)	Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array bilangan bulat bertanda tangan 8-bit, posisi awal dalam array tersebut, panjang, dan Encoding objek.

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk konstruktor String.

String(Char*)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array karakter Unicode.

public:
 String(char* value);

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

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

Parameter

value

Char*

Penunjuk ke array karakter Unicode yang dihentikan null.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

Proses saat ini tidak memiliki akses baca ke semua karakter yang ditangani.

ArgumentException

value menentukan array yang berisi karakter Unicode yang tidak valid, atau value menentukan alamat kurang dari 64000.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.

String(Char[])

Sumber:

String.cs

Menginisialisasi instans String baru kelas ke karakter Unicode yang ditunjukkan dalam array karakter yang ditentukan.

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

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

Parameter

value

Char[]

Array karakter Unicode.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.

String(ReadOnlySpan<Char>)

Sumber:

String.cs

Menginisialisasi instans String baru kelas ke karakter Unicode yang ditunjukkan dalam rentang baca-saja yang ditentukan.

public:
 String(ReadOnlySpan<char> value);

public String (ReadOnlySpan<char> value);

new string : ReadOnlySpan<char> -> string

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

Parameter

value

ReadOnlySpan<Char>

Rentang baca-saja dari karakter Unicode.

String(SByte*)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk ke array bilangan bulat bertanda tangan 8-bit.

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

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

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

Parameter

value

SByte*

Penunjuk ke array bilangan bulat bertanda tangan 8-bit yang dihentikan null. Bilangan bulat ditafsirkan menggunakan pengodean halaman kode sistem saat ini (yaitu, pengodean yang ditentukan oleh Default).

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

valueadalah null.

ArgumentException

Instans String baru tidak dapat diinisialisasi menggunakan value, dengan asumsi value dikodekan di ANSI.

ArgumentOutOfRangeException

Panjang string baru untuk diinisialisasi, yang ditentukan oleh karakter penghentian null , valueterlalu besar untuk dialokasikan.

AccessViolationException

value menentukan alamat yang tidak valid.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.

String(Char, Int32)

Sumber:

String.cs

Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh karakter Unicode tertentu yang mengulangi beberapa kali tertentu.

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)

Parameter

c

Char

Karakter Unicode.

count

Int32

Berapa kali c terjadi.

Pengecualian

ArgumentOutOfRangeException

count kurang dari nol.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.

String(Char*, Int32, Int32)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array karakter Unicode, posisi karakter awal dalam array tersebut, dan panjangnya.

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

Parameter

value

Char*

Penunjuk ke array karakter Unicode.

startIndex

Int32

Posisi awal dalam value.

length

Int32

Jumlah karakter dalam value yang akan digunakan.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentOutOfRangeException

startIndex atau length kurang dari nol, value + startIndex menyebabkan luapan pointer, atau proses saat ini tidak memiliki akses baca ke semua karakter yang ditangani.

ArgumentException

value menentukan array yang berisi karakter Unicode yang tidak valid, atau value + startIndex menentukan alamat kurang dari 64000.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.

String(Char[], Int32, Int32)

Sumber:

String.cs

Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh array karakter Unicode, posisi karakter awal dalam array tersebut, dan panjangnya.

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)

Parameter

value

Char[]

Array karakter Unicode.

startIndex

Int32

Posisi awal dalam value.

length

Int32

Jumlah karakter dalam value yang akan digunakan.

Pengecualian

ArgumentNullException

valueadalah null.

ArgumentOutOfRangeException

startIndex atau length kurang dari nol.

-atau-

Jumlah startIndex dan length lebih besar dari jumlah elemen dalam value.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.

String(SByte*, Int32, Int32)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array bilangan bulat bertanda tangan 8-bit, posisi awal dalam array tersebut, dan panjangnya.

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

Parameter

value

SByte*

Penunjuk ke array bilangan bulat bertanda tangan 8-bit. Bilangan bulat ditafsirkan menggunakan pengodean halaman kode sistem saat ini (yaitu, pengodean yang ditentukan oleh Default).

startIndex

Int32

Posisi awal dalam value.

length

Int32

Jumlah karakter dalam value yang akan digunakan.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

valueadalah null.

ArgumentOutOfRangeException

startIndex atau length kurang dari nol.

-atau-

Alamat yang ditentukan oleh value + startIndex terlalu besar untuk platform saat ini; yaitu, perhitungan alamat meluap.

-atau-

Panjang string baru untuk diinisialisasi terlalu besar untuk dialokasikan.

ArgumentException

Alamat yang ditentukan oleh value + startIndex kurang dari 64K.

-atau-

Instans String baru tidak dapat diinisialisasi menggunakan value, dengan asumsi value dikodekan di ANSI.

AccessViolationException

value, startIndex, dan length secara kolektif menentukan alamat yang tidak valid.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.

String(SByte*, Int32, Int32, Encoding)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

Menginisialisasi instans String baru kelas ke nilai yang ditunjukkan oleh penunjuk tertentu ke array bilangan bulat bertanda tangan 8-bit, posisi awal dalam array tersebut, panjang, dan Encoding objek.

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

Parameter

value

SByte*

Penunjuk ke array bilangan bulat bertanda tangan 8-bit.

startIndex

Int32

Posisi awal dalam value.

length

Int32

Jumlah karakter dalam value yang akan digunakan.

enc

Encoding

Objek yang menentukan bagaimana array yang direferensikan oleh value dikodekan. Jika enc adalah null, pengodean ANSI diasumsikan.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

valueadalah null.

ArgumentOutOfRangeException

startIndex atau length kurang dari nol.

-atau-

Alamat yang ditentukan oleh value + startIndex terlalu besar untuk platform saat ini; yaitu, perhitungan alamat meluap.

-atau-

Panjang string baru untuk diinisialisasi terlalu besar untuk dialokasikan.

ArgumentException

Alamat yang ditentukan oleh value + startIndex kurang dari 64K.

-atau-

Instans String baru tidak dapat diinisialisasi menggunakan value, dengan value asumsi dikodekan seperti yang ditentukan oleh enc.

AccessViolationException

value, startIndex, dan length secara kolektif menentukan alamat yang tidak valid.

Keterangan

Catatan

Untuk contoh dan informasi penggunaan komprehensif tentang ini dan kelebihan beban konstruktor lainnya String , lihat String ringkasan konstruktor.