String Konstruktor

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Menginisialisasi instans baru kelas String.

Overload

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

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 baru kelas String 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

Nota

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

String(Char[])

Sumber:

String.cs

Menginisialisasi instans baru kelas String 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

Nota

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

String(ReadOnlySpan<Char>)

Sumber:

String.cs

Menginisialisasi instans baru kelas String 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 baru kelas String 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 pada Windows (disebut sebagai CP_ACP) dan sebagai pengodean UTF-8 pada non-Windows.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

value null.

ArgumentException

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

ArgumentOutOfRangeException

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

AccessViolationException

value menentukan alamat yang tidak valid.

Keterangan

Nota

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

String(Char, Int32)

Sumber:

String.cs

Menginisialisasi instans baru kelas String ke nilai yang ditunjukkan oleh karakter Unicode tertentu mengulangi jumlah waktu yang ditentukan.

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

Nota

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

String(Char*, Int32, Int32)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

Menginisialisasi instans baru kelas String 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

Nota

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

String(Char[], Int32, Int32)

Sumber:

String.cs

Menginisialisasi instans baru kelas String 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

value null.

ArgumentOutOfRangeException

startIndex atau length kurang dari nol.

-atau-

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

Keterangan

Nota

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

String(SByte*, Int32, Int32)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

Menginisialisasi instans baru kelas String ke nilai yang ditunjukkan oleh pointer 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 pada Windows (disebut sebagai CP_ACP) dan sebagai pengodean UTF-8 pada non-Windows.

startIndex

Int32

Posisi awal dalam value.

length

Int32

Jumlah karakter dalam value yang akan digunakan.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

value null.

ArgumentOutOfRangeException

startIndex atau length kurang dari nol.

-atau-

Alamat yang ditentukan oleh value + startIndex terlalu besar untuk platform saat ini; artinya, 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 baru String tidak dapat diinisialisasi menggunakan value, dengan asumsi value dikodekan di ANSI.

AccessViolationException

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

Keterangan

Nota

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

String(SByte*, Int32, Int32, Encoding)

Sumber:

String.cs

Penting

API ini bukan kompatibel CLS.

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

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 encnull, pengodean ANSI diasumsikan.

Atribut

CLSCompliantAttribute

Pengecualian

ArgumentNullException

value null.

ArgumentOutOfRangeException

startIndex atau length kurang dari nol.

-atau-

Alamat yang ditentukan oleh value + startIndex terlalu besar untuk platform saat ini; artinya, 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 baru String tidak dapat diinisialisasi menggunakan value, dengan asumsi value dikodekan seperti yang ditentukan oleh enc.

AccessViolationException

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

Keterangan

Nota

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