Bagikan melalui

ref jenis struktur (referensi C#)

  • Artikel

Anda dapat menggunakan pengubah ref dalam deklarasi jenis struktur. Instans jenis ref struct dialokasikan pada tumpukan dan tidak dapat lolos ke tumpukan terkelola. Untuk memastikan bahwa, pengkompilasi membatasi penggunaan jenis ref struct sebagai berikut:

  • ref struct Tidak boleh menjadi jenis elemen array.
  • ref struct Tidak dapat berupa jenis bidang kelas atau non-yangref struct dideklarasikan.
  • Tidak ref struct dapat menerapkan antarmuka.
  • ref struct Tidak dapat dikotak ke System.ValueType atau System.Object.
  • Tidak ref struct dapat berupa argumen jenis.
  • Variabel ref struct tidak dapat diambil dalam ekspresi lambda atau fungsi lokal.
  • Sebelum C# 13,ref struct variabel tidak dapat digunakan dalam async metode . Dimulai dengan C# 13, ref struct variabel tidak dapat digunakan dalam blok await yang sama dengan ekspresi dalam async metode . Namun, Anda dapat menggunakan ref struct variabel dalam metode sinkron, misalnya, dalam metode yang mengembalikan Task atau Task<TResult>.
  • Sebelum C# 13, ref struct variabel tidak dapat digunakan dalam iterator. Dimulai dengan C# 13, ref struct jenis dan ref lokal dapat digunakan dalam iterator, asalkan mereka tidak berada dalam segmen kode dengan yield return pernyataan.

Anda dapat menentukan sekali pakai ref struct. Untuk melakukan itu, pastikan bahwa ref struct sesuai dengan pola sekali pakai. Artinya, ia memiliki metode instans Dispose , yang dapat diakses, tanpa parameter dan memiliki void jenis pengembalian. Anda dapat menggunakan pernyataan penggunaan atau deklarasi dengan instans sekali pakai ref struct.

Biasanya, Anda menentukan ref struct jenis saat Anda memerlukan jenis yang juga menyertakan anggota data dari jenis ref struct :

public ref struct CustomRef
{
    public bool IsValid;
    public Span<int> Inputs;
    public Span<int> Outputs;
}

Untuk mendeklarasikan ref struct sebagai readonly, gabungkan readonly pengubah dan ref dalam deklarasi jenis ( readonly pengubah harus datang sebelum pengubah ref ):

public readonly ref struct ConversionRequest
{
    public ConversionRequest(double rate, ReadOnlySpan<double> values)
    {
        Rate = rate;
        Values = values;
    }

    public double Rate { get; }
    public ReadOnlySpan<double> Values { get; }
}

Di .NET, contoh ref struct adalah System.Span<T> dan System.ReadOnlySpan<T>.

ref Bidang

Dimulai dengan C# 11, Anda dapat mendeklarasikan ref bidang dalam , seperti yang ditunjukkan ref structcontoh berikut:

public ref struct RefFieldExample
{
    private ref int number;

    public int GetNumber()
    {
        if (System.Runtime.CompilerServices.Unsafe.IsNullRef(ref number))
        {
            throw new InvalidOperationException("The number ref field is not initialized.");
        }

        return number;
    }
}

Bidang ref dapat memiliki nilai .null Unsafe.IsNullRef<T>(T) Gunakan metode untuk menentukan apakah ref bidang adalah null.

Anda bisa menerapkan pengubah readonly ke ref bidang dengan cara berikut:

  • readonly ref: Anda dapat menetapkan ulang bidang tersebut = ref dengan operator hanya di dalam konstruktor atau init aksesor. Anda dapat menetapkan nilai dengan = operator kapan saja yang diizinkan oleh pengubah akses bidang.
  • ref readonly: Pada titik mana pun, Anda tidak dapat menetapkan nilai dengan operator ke bidang seperti itu = . Namun, Anda dapat menetapkan ulang bidang dengan = ref operator.
  • readonly ref readonly: Anda hanya dapat menetapkan ulang bidang tersebut di konstruktor atau init aksesor. Pada titik mana pun, Anda tidak dapat menetapkan nilai ke bidang .

Pengkompilasi memastikan bahwa referensi yang disimpan di ref bidang tidak melampaui referensinya.

Fitur ref bidang memungkinkan implementasi jenis yang aman seperti System.Span<T>:

public readonly ref struct Span<T>
{
    internal readonly ref T _reference;
    private readonly int _length;

    // Omitted for brevity...
}

Jenis menyimpan Span<T> referensi di mana ia mengakses elemen yang bersebelahan dalam memori. Penggunaan referensi memungkinkan instans Span<T> untuk menghindari penyalinan penyimpanan yang dirujuknya.

Spesifikasi bahasa C#

Untuk informasi selengkapnya, lihat bagian berikut dari spesifikasi bahasa C#:

Untuk informasi selengkapnya tentang ref bidang, lihat catatan proposal peningkatan struct tingkat rendah.

Lihat juga