AggregateException Construtores

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Inicializa uma nova instância da classe AggregateException.

Sobrecargas

Nome	Description
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 AggregateException classe com referências às exceções internas que são a causa dessa exceção.
AggregateException(Exception[])	Inicializa uma nova instância da AggregateException classe 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 AggregateException classe com dados serializados.
AggregateException(String, IEnumerable<Exception>)	Inicializa uma nova instância da AggregateException classe com uma mensagem de erro especificada e faz referência às exceções internas que são a causa dessa exceção.
AggregateException(String, Exception)	Inicializa uma nova instância da AggregateException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.
AggregateException(String, Exception[])	Inicializa uma nova instância da AggregateException classe com uma mensagem de erro especificada e faz referência à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 iniciais de uma instância de AggregateException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres de 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 AggregateException classe 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 innerExceptions argumento é nulo.

ArgumentException

Um elemento de innerExceptions é nulo.

AggregateException(Exception[])

Origem:

AggregateException.cs

Inicializa uma nova instância da AggregateException classe 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 innerExceptions argumento é 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 desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.

Comentários

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

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres de mensagem de erro especificada em 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 AggregateException classe 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 contém os dados do objeto serializado.

context

StreamingContext

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

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

O info argumento é nulo.

SerializationException

A exceção não pôde ser desserializada corretamente.

Comentários

Esse construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido por um fluxo. Para obter mais informações, consulte de 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 AggregateException classe com uma mensagem de erro especificada e faz referência à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 o motivo da exceção.

innerExceptions

IEnumerable<Exception>

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

Exceções

ArgumentNullException

O innerExceptions argumento é nulo.

ArgumentException

Um elemento de innerExceptions é nulo.

AggregateException(String, Exception)

Origem:

AggregateException.cs

Inicializa uma nova instância da AggregateException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa 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 desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.

innerException

Exception

A exceção que é a causa da exceção atual. Se o innerException parâmetro não nullfor, a exceção atual será gerada em um catch bloco que manipula a exceção interna.

Exceções

ArgumentNullException

O innerException argumento é nulo.

Comentários

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

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

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres de mensagem de erro especificada em message.

Confira também

• Manipulando e lançando exceções

AggregateException(String, Exception[])

Origem:

AggregateException.cs

Inicializa uma nova instância da AggregateException classe com uma mensagem de erro especificada e faz referência à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 o motivo da exceção.

innerExceptions

Exception[]

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

Exceções

ArgumentNullException

O innerExceptions argumento é nulo.

ArgumentException

Um elemento de innerExceptions é nulo.