AggregateException Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Inicializa uma nova instância da classe AggregateException.

Sobrecargas

AggregateException()	Inicializa uma nova instância da classe AggregateException com uma mensagem fornecida pelo sistema que descreve o erro.
AggregateException(IEnumerable<Exception>)	Inicializa uma nova instância da classe AggregateException com referências às exceções internas que são a causa dessa exceção.
AggregateException(Exception[])	Inicializa uma nova instância da classe AggregateException com referências às exceções internas que são a causa dessa exceção.
AggregateException(String)	Inicializa uma nova instância da classe AggregateException com uma mensagem especificada que descreve o erro.
AggregateException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe AggregateException com dados serializados.
AggregateException(String, IEnumerable<Exception>)	Inicializa uma nova instância da classe AggregateException com uma mensagem de erro especificada e referências às exceções internas que são a causa dessa exceção.
AggregateException(String, Exception)	Inicializa uma nova instância da classe AggregateException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.
AggregateException(String, Exception[])	Inicializa uma nova instância da classe AggregateException com uma mensagem de erro especificada e referências às exceções internas que são a causa dessa exceção.

AggregateException()

Origem:

AggregateException.cs

Inicializa uma nova instância da classe AggregateException com uma mensagem fornecida pelo sistema que descreve o erro.

public:
 AggregateException();

public AggregateException ();

Public Sub New ()

Comentários

Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "System.AggregateException: ocorreu um ou mais erros". Essa mensagem leva em conta a cultura atual do sistema.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de AggregateException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres da mensagem de erro localizada.

Confira também

• Manipulando e lançando exceções

AggregateException(IEnumerable<Exception>)

Origem:

AggregateException.cs

Inicializa uma nova instância da classe AggregateException com referências às exceções internas que são a causa dessa exceção.

public:
 AggregateException(System::Collections::Generic::IEnumerable<Exception ^> ^ innerExceptions);

public AggregateException (System.Collections.Generic.IEnumerable<Exception> innerExceptions);

new AggregateException : seq<Exception> -> AggregateException

Public Sub New (innerExceptions As IEnumerable(Of Exception))

Parâmetros

innerExceptions

IEnumerable<Exception>

As exceções que são a causa da exceção atual.

Exceções

ArgumentNullException

O argumento innerExceptions é nulo.

ArgumentException

Um elemento de innerExceptions é nulo.

AggregateException(Exception[])

Origem:

AggregateException.cs

Inicializa uma nova instância da classe AggregateException com referências às exceções internas que são a causa dessa exceção.

public:
 AggregateException(... cli::array <Exception ^> ^ innerExceptions);

public AggregateException (params Exception[] innerExceptions);

new AggregateException : Exception[] -> AggregateException

Public Sub New (ParamArray innerExceptions As Exception())

Parâmetros

innerExceptions

Exception[]

As exceções que são a causa da exceção atual.

Exceções

ArgumentNullException

O argumento innerExceptions é nulo.

ArgumentException

Um elemento de innerExceptions é nulo.

AggregateException(String)

Origem:

AggregateException.cs

Inicializa uma nova instância da classe AggregateException com uma mensagem especificada que descreve o erro.

public:
 AggregateException(System::String ^ message);

public AggregateException (string? message);

new AggregateException : string -> AggregateException

Public Sub New (message As String)

Parâmetros

message

String

A mensagem que descreve a exceção. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

Comentários

A tabela a seguir mostra os valores de propriedade inicial de uma instância de AggregateException.

Propriedade	Valor
InnerException	null.
Message	A cadeia da mensagem de erro especificada na message.

Confira também

• Manipulando e lançando exceções

AggregateException(SerializationInfo, StreamingContext)

Origem:

AggregateException.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe AggregateException com dados serializados.

protected:
 AggregateException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected AggregateException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new AggregateException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> AggregateException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info

SerializationInfo

O objeto que mantém os dados de objeto serializados.

context

StreamingContext

As informações contextuais sobre a origem ou o destino.

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

O argumento info é nulo.

SerializationException

Não foi possível desserializar a exceção corretamente.

Comentários

O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo. Para obter mais informações, consulte serialização XML e SOAP.

Confira também

• Serialização XML e SOAP

AggregateException(String, IEnumerable<Exception>)

Origem:

AggregateException.cs

Inicializa uma nova instância da classe AggregateException com uma mensagem de erro especificada e referências às exceções internas que são a causa dessa exceção.

public:
 AggregateException(System::String ^ message, System::Collections::Generic::IEnumerable<Exception ^> ^ innerExceptions);

public AggregateException (string? message, System.Collections.Generic.IEnumerable<Exception> innerExceptions);

new AggregateException : string * seq<Exception> -> AggregateException

Public Sub New (message As String, innerExceptions As IEnumerable(Of Exception))

Parâmetros

message

String

A mensagem de erro que explica a razão da exceção.

innerExceptions

IEnumerable<Exception>

As exceções que são a causa da exceção atual.

Exceções

ArgumentNullException

O argumento innerExceptions é nulo.

ArgumentException

Um elemento de innerExceptions é nulo.

AggregateException(String, Exception)

Origem:

AggregateException.cs

Inicializa uma nova instância da classe AggregateException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.

public:
 AggregateException(System::String ^ message, Exception ^ innerException);

public AggregateException (string? message, Exception innerException);

new AggregateException : string * Exception -> AggregateException

Public Sub New (message As String, innerException As Exception)

Parâmetros

message

String

A mensagem que descreve a exceção. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

innerException

Exception

A exceção que é a causa da exceção atual. Caso o parâmetro innerException não seja null, a exceção atual é acionada em um bloco catch que identifica a exceção interna.

Exceções

ArgumentNullException

O argumento innerException é nulo.

Comentários

Uma exceção que é lançada como um resultado direto de uma exceção anterior deve incluir uma referência para a exceção anterior na propriedade InnerException. A propriedade InnerException retorna o mesmo valor passado ao construtor, ou null se a propriedade InnerException não fornecer o valor da exceção interna ao construtor.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de AggregateException.

Propriedade	Valor
InnerException	null.
Message	A cadeia da mensagem de erro especificada na message.

Confira também

• Manipulando e lançando exceções

AggregateException(String, Exception[])

Origem:

AggregateException.cs

Inicializa uma nova instância da classe AggregateException com uma mensagem de erro especificada e referências às exceções internas que são a causa dessa exceção.

public:
 AggregateException(System::String ^ message, ... cli::array <Exception ^> ^ innerExceptions);

public AggregateException (string? message, params Exception[] innerExceptions);

new AggregateException : string * Exception[] -> AggregateException

Public Sub New (message As String, ParamArray innerExceptions As Exception())

Parâmetros

message

String

A mensagem de erro que explica a razão da exceção.

innerExceptions

Exception[]

As exceções que são a causa da exceção atual.

Exceções

ArgumentNullException

O argumento innerExceptions é nulo.

ArgumentException

Um elemento de innerExceptions é nulo.