unsafe (Справочник по C#)unsafe (C# Reference)

Ключевое слово unsafe обозначает небезопасный контекст, необходимый для выполнения любых операций с применением указателей.The unsafe keyword denotes an unsafe context, which is required for any operation involving pointers. Дополнительные сведения см. в разделе Небезопасный код и указатели.For more information, see Unsafe Code and Pointers.

В объявлении типа или члена типа можно использовать модификатор unsafe.You can use the unsafe modifier in the declaration of a type or a member. Все текстовое пространство типа или члена типа считается небезопасным контекстом.The entire textual extent of the type or member is therefore considered an unsafe context. Например, следующий метод объявлен с модификатором unsafe:For example, the following is a method declared with the unsafe modifier:

unsafe static void FastCopy(byte[] src, byte[] dst, int count)
{
    // Unsafe context: can use pointers here.
}

Область небезопасного контекста простирается от списка параметров до конца метода, поэтому в списке параметров можно также использовать указатели:The scope of the unsafe context extends from the parameter list to the end of the method, so pointers can also be used in the parameter list:

unsafe static void FastCopy ( byte* ps, byte* pd, int count ) {...}

Кроме того, небезопасный блок позволяет добавлять небезопасный код в блок.You can also use an unsafe block to enable the use of an unsafe code inside this block. Например:For example:

unsafe
{
    // Unsafe context: can use pointers here.
}

Чтобы скомпилировать небезопасный код, необходимо указать параметр компилятора -unsafe.To compile unsafe code, you must specify the -unsafe compiler option. Небезопасный код не проверяется средой CLR.Unsafe code is not verifiable by the common language runtime.

ПримерExample

// compile with: -unsafe
class UnsafeTest
{
    // Unsafe method: takes pointer to int.
    unsafe static void SquarePtrParam(int* p)
    {
        *p *= *p;
    }

    unsafe static void Main()
    {
        int i = 5;
        // Unsafe method: uses address-of operator (&).
        SquarePtrParam(&i);
        Console.WriteLine(i);
    }
}
// Output: 25

Спецификация языка C#C# language specification

Дополнительные сведения см. в разделе Небезопасный код в Спецификации языка C#.For more information, see Unsafe code in the C# Language Specification. Спецификация языка является предписывающим источником информации о синтаксисе и использовании языка C#.The language specification is the definitive source for C# syntax and usage.

См. такжеSee also