Bagikan melalui


String Konstruktor

Definisi

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
Sumber:
String.cs
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)]
[System.Security.SecurityCritical]
public String (char* value);
[System.CLSCompliant(false)]
public String (char* value);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> -> string
[<System.CLSCompliant(false)>]
new string : nativeptr<char> -> string

Parameter

value
Char*

Penunjuk ke array karakter Unicode yang dihentikan null.

Atribut

Pengecualian

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

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.

Berlaku untuk

String(Char[])

Sumber:
String.cs
Sumber:
String.cs
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);
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.

Berlaku untuk

String(ReadOnlySpan<Char>)

Sumber:
String.cs
Sumber:
String.cs
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.

Berlaku untuk

String(SByte*)

Sumber:
String.cs
Sumber:
String.cs
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)]
[System.Security.SecurityCritical]
public String (sbyte* value);
[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

Pengecualian

value null.

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

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

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.

Berlaku untuk

String(Char, Int32)

Sumber:
String.cs
Sumber:
String.cs
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

count kurang dari nol.

Keterangan

Nota

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

Berlaku untuk

String(Char*, Int32, Int32)

Sumber:
String.cs
Sumber:
String.cs
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)]
[System.Security.SecurityCritical]
public String (char* value, int startIndex, int length);
[System.CLSCompliant(false)]
public String (char* value, int startIndex, int length);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> * int * int -> string
[<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

Pengecualian

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

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.

Berlaku untuk

String(Char[], Int32, Int32)

Sumber:
String.cs
Sumber:
String.cs
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

value null.

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.

Berlaku untuk

String(SByte*, Int32, Int32)

Sumber:
String.cs
Sumber:
String.cs
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)]
[System.Security.SecurityCritical]
public String (sbyte* value, int startIndex, int length);
[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int -> string
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

Pengecualian

value null.

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.

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

-atau-

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

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.

Berlaku untuk

String(SByte*, Int32, Int32, Encoding)

Sumber:
String.cs
Sumber:
String.cs
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)]
[System.Security.SecurityCritical]
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
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
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

Pengecualian

value null.

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.

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.

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.

Berlaku untuk