Partilhar via

inseguro (Referência C#)

A unsafe palavra-chave denota um contexto inseguro, que é necessário para qualquer operação que envolva ponteiros. Para obter mais informações, consulte Código e ponteiros não seguros.

A referência da linguagem C# documenta a versão mais recentemente lançada da linguagem C#. Contém também documentação inicial para funcionalidades em versões preliminares públicas para a próxima versão da linguagem.

A documentação identifica qualquer funcionalidade introduzida pela primeira vez nas últimas três versões da língua ou em pré-visualizações públicas atuais.

Sugestão

Para saber quando uma funcionalidade foi introduzida pela primeira vez em C#, consulte o artigo sobre o histórico de versões da linguagem C#.

Use o unsafe modificador na declaração de um tipo ou membro. Toda a extensão textual do tipo ou membro é um contexto inseguro. Por exemplo, o seguinte método é declarado com o unsafe modificador:

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

O âmbito do contexto inseguro estende-se da lista de parâmetros até ao fim do método, por isso também pode usar ponteiros na lista de parâmetros:

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

Também pode usar um bloco inseguro para permitir o uso de código inseguro dentro desse bloco. Por exemplo:

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

Para compilar código não seguro, você deve especificar a opção de compilador AllowUnsafeBlocks . O runtime da common language não consegue verificar código inseguro.

Exemplo

// 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

Especificação da linguagem C#

Para obter mais informações, consulte Código não seguro na Especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso do C#.

Ver também

  • Last updated on