Compartilhar via


Conversões cast e conversões de tipo (Guia de Programação em C#)

Como o C# é estaticamente tipado no momento de compilar, após uma variável ser declarada, ela não pode ser declarada novamente ou usada para armazenar valores de outro tipo a menos que esse tipo seja conversível para o tipo da variável. Por exemplo, não há nenhuma conversão de um número inteiro para qualquer seqüência de caracteres arbitrária. Portanto, após declarar i como um inteiro, você não pode atribuir a seqüência de caracteres "Hello", conforme é mostrado no código a seguir.

int i;
i = "Hello"; // Error: "Cannot implicitly convert type 'string' to 'int'"

No entanto, às vezes, talvez seja necessário copiar um valor para um parâmetro de método ou variável de outro tipo. Por exemplo, você pode ter uma variável integer que você precisa passar para um método cujo parâmetro é digitado como double. Ou talvez você precise atribuir uma variável de classe a uma variável de um tipo de interface. Esses tipos de operações são chamados de as conversões de tipo. Na C#, você pode realizar os seguintes tipos de conversões:

Conversões implícitas

Para tipos numéricos internos (ou primitivos), uma conversão implícita pode ser feita quando o valor a ser armazenado puder caber na varíavel, sem ser truncado ou arredondado. Por exemplo, uma variável do tipo longo (inteiro de 8 bytes) pode armazenar qualquer valor que uma int (4 bytes em um computador de 32 bits) pode armazenar. No exemplo a seguir, o compilador converte implicitamente o valor à direita para um tipo de long antes de atribuí-lo para bigNum.

// Implicit conversion. num long can 
// hold any value an int can hold, and more! 
int num = 2147483647;
long bigNum = num;

Para obter uma lista completa de todas as conversões implícitas de numéricas, consulte Tabela de conversões numéricas implícitas (Referência de C#).

Tipos de referência, uma conversão implícita sempre existe de uma classe para qualquer uma das suas interfaces ou classes base diretas ou indiretas. Nenhuma sintaxe especial é necessária porque uma classe derivada sempre contém todos os membros de uma classe base.

Derived d = new Derived();
Base b = d; // Always OK.

Conversões explícitas

No entanto, se uma conversão não pode ser feita sem um risco de perda de informações, o compilador requer que você executa uma conversão explícita, o que é chamada de um cast. A projeção é uma maneira de informar explicitamente o compilador que você pretende fazer a conversão e que você está ciente de que pode ocorrer perda de dados. Para executar uma conversão, especifique o tipo que são a projeção para entre parênteses na frente do valor ou variável a ser convertido. O seguinte programa projeções de um double para um int. O programa não será compilado sem a projeção.

class Test
{
    static void Main()
    {
        double x = 1234.7;
        int a;
        // Cast double to int.
        a = (int)x;
        System.Console.WriteLine(a);
    }
}
// Output: 1234

Para obter uma lista as conversões explícitas numéricas permitidos, consulte Tabela de conversões numéricas explícitas (Referência de C#).

Para tipos de referência, uma conversão explícita é necessária se você precisar converter de um tipo base para um tipo derivado:

// Create a new derived type.
Giraffe g = new Giraffe();

// Implicit conversion to base type is safe.
Animal a = g;

// Explicit conversion is required to cast back
// to derived type. Note: This will compile but will
// throw an exception at run time if the right-side
// object is not in fact a Giraffe.
Giraffe g2 = (Giraffe) a;

Uma operação de conversão entre tipos de referência não altera o tipo de tempo de execução do objeto subjacente; ele apenas altera o tipo do valor que está sendo usado como uma referência a esse objeto. Para obter mais informações, consulte Polimorfismo (Guia de Programação em C#).

Exceções de conversão de tipo em tempo de execução

Em algumas conversões de tipo de referência, o compilador não pode determinar se um elenco será válido. É possível que uma operação de conversão que compile corretamente a falhar em tempo de execução. Conforme mostrado no exemplo a seguir, um tipo de projeção que falhar em tempo de execução fará com que uma InvalidCastException seja lançada.

class Animal
{
    public void Eat() { Console.WriteLine("Eating."); }
    public override string ToString()
    {
        return "I am an animal.";
    }
}
class Reptile : Animal { }
class Mammal : Animal { }

class UnSafeCast
{
    static void Main()
    {            
        Test(new Mammal());

        // Keep the console window open in debug mode.
        System.Console.WriteLine("Press any key to exit.");
        System.Console.ReadKey();
    }

    static void Test(Animal a)
    {
        // Cause InvalidCastException at run time  
        // because Mammal is not convertible to Reptile.
        Reptile r = (Reptile)a;
    }

}

C# fornece a é e como operadores para que você possa testar a compatibilidade antes de realmente executar uma conversão. Para obter mais informações, consulte Como executar conversão cast com segurança usando operadores as e is (Guia de Programação em C#).

Especificação da linguagem C#

Para obter mais informações, consulte a Especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso de C#.

Capítulo do livro em destaque

Mais informações sobre variáveis de na início 2010 do Visual C#

Consulte também

Tarefas

Como converter uma cadeia de caracteres em um número (Guia de Programação em C#)

Referência

Tipos (Guia de Programação em C#)

Operador () (Referência de C#)

explicit (Referência de C#)

implicit (Referência de C#)

Operadores de conversão (Guia de Programação em C#)

Conceitos

Guia de Programação em C#

Conversão de tipos generalizada

Conversão de tipos exportados