Operadores de conversão definidos pelo usuário (Referência de C#)User-defined conversion operators (C# reference)

Um tipo definido pelo usuário pode definir uma conversão implícita ou explícita personalizada de outro tipo ou para outro.A user-defined type can define a custom implicit or explicit conversion from or to another type.

Conversões implícitas não requerem que uma sintaxe especial seja invocada e podem ocorrer em uma variedade de situações, por exemplo, em atribuições e invocações de método.Implicit conversions don't require special syntax to be invoked and can occur in a variety of situations, for example, in assignments and methods invocations. Conversões implícitas de C# predefinidas sempre são bem sucedidos e nunca geram uma exceção.Predefined C# implicit conversions always succeed and never throw an exception. Conversões implícitas definidas pelo usuário devem se comportam dessa forma também.User-defined implicit conversions should behave in that way as well. Se uma conversão personalizada puder gerar uma exceção ou perder informações, defina-a como uma conversão explícita.If a custom conversion can throw an exception or lose information, define it as an explicit conversion.

Conversões definidas pelo usuário não são consideradas pelos operadores is e as.User-defined conversions are not considered by the is and as operators. Use uma expressão de conversão para invocar uma conversão explícita definida pelo usuário.Use a cast expression to invoke a user-defined explicit conversion.

Use operator e as palavras-chave implicit ou explicit para definir uma conversão implícita ou explícita, respectivamente.Use the operator and implicit or explicit keywords to define an implicit or explicit conversion, respectively. O tipo que define uma conversão deve ser um tipo de origem ou e destino dessa conversão.The type that defines a conversion must be either a source type or a target type of that conversion. Uma conversão entre os dois tipos definidos pelo usuário pode ser definida em qualquer um dos dois tipos.A conversion between two user-defined types can be defined in either of the two types.

O exemplo a seguir demonstra como definir uma conversão implícita e explícita:The following example demonstrates how to define an implicit and explicit conversion:

using System;

public readonly struct Digit
{
    private readonly byte digit;

    public Digit(byte digit)
    {
        if (digit > 9)
        {
            throw new ArgumentOutOfRangeException(nameof(digit), "Digit cannot be greater than nine.");
        }
        this.digit = digit;
    }

    public static implicit operator byte(Digit d) => d.digit;
    public static explicit operator Digit(byte b) => new Digit(b);

    public override string ToString() => $"{digit}";
}

public static class UserDefinedConversions
{
    public static void Main()
    {
        var d = new Digit(7);

        byte number = d;
        Console.WriteLine(number);  // output: 7

        Digit digit = (Digit)number;
        Console.WriteLine(digit);  // output: 7
    }
}

Use também a palavra-chave operator para sobrecarregar um operador C# predefinido.You also use the operator keyword to overload a predefined C# operator. Para obter mais informações, consulte Sobrecarga de operador.For more information, see Operator overloading.

Especificação da linguagem C#C# language specification

Para obter mais informações, confira as seguintes seções da especificação da linguagem C#:For more information, see the following sections of the C# language specification:

Confira tambémSee also