BigInteger.Multiply(BigInteger, BigInteger) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna o produto de dois valores BigInteger.
public:
static System::Numerics::BigInteger Multiply(System::Numerics::BigInteger left, System::Numerics::BigInteger right);public static System.Numerics.BigInteger Multiply (System.Numerics.BigInteger left, System.Numerics.BigInteger right);static member Multiply : System.Numerics.BigInteger * System.Numerics.BigInteger -> System.Numerics.BigIntegerPublic Shared Function Multiply (left As BigInteger, right As BigInteger) As BigIntegerParâmetros
- left
- BigInteger
O primeiro número a multiplicar.
- right
- BigInteger
O segundo número a multiplicar.
Retornos
O produto dos parâmetros left e right.
Exemplos
O exemplo a seguir tenta executar multiplicação com dois inteiros longos. Como o resultado excede o intervalo de um inteiro longo, um OverflowException é gerado e o Multiply método é chamado para lidar com a multiplicação. Observe que o C# exige que você use a checked palavra-chave (como neste exemplo) ou a opção do /checked+ compilador para garantir que uma exceção seja gerada em um estouro numérico.
long number1 = 1234567890;
long number2 = 9876543210;
try
{
long product;
product = checked(number1 * number2);
}
catch (OverflowException)
{
BigInteger product;
product = BigInteger.Multiply(number1, number2);
Console.WriteLine(product.ToString());
}
Dim number1 As Long = 1234567890
Dim number2 As Long = 9876543210
Try
Dim product As Long
product = number1 * number2
Console.WriteLine(product.ToString("N0"))
Catch e As OverflowException
Dim product As BigInteger
product = BigInteger.Multiply(number1, number2)
Console.WriteLine(product.ToString)
End Try
Comentários
O Multiply método é implementado para idiomas que não dão suporte à sobrecarga do operador. Seu comportamento é idêntico à multiplicação usando o operador de multiplicação. Além disso, o Multiply método é um substituto útil para o operador de multiplicação ao instanciar uma BigInteger variável atribuindo-lhe um produto que resulta da multiplicação, conforme mostrado no exemplo a seguir.
// The statement
// BigInteger number = Int64.MaxValue * 3;
// produces compiler error CS0220: The operation overflows at compile time in checked mode.
// The alternative:
BigInteger number = BigInteger.Multiply(Int64.MaxValue, 3);
' The statement
' Dim number As BigInteger = Int64.MaxValue * 3
' produces compiler error BC30439: Constant expression not representable in type 'Long'.
' The alternative:
Dim number As BigInteger = BigInteger.Multiply(Int64.MaxValue, 3)
Se necessário, esse método executa automaticamente a conversão implícita de outros tipos integrais em BigInteger objetos. Isso é ilustrado no exemplo na próxima seção, em que o Multiply método é passado dois Int64 valores.