IOException Construtores

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Inicializa uma nova instância da classe IOException com a respectiva cadeia de caracteres de mensagem.

Sobrecargas

IOException()	Inicializa uma nova instância da classe IOException com sua cadeia de caracteres de mensagem definida como a cadeia de caracteres vazia (""), o HRESULT é definido como COR_E_IO e sua exceção interna é definida como uma referência nula.
IOException(String)	Inicializa uma nova instância da classe IOException com sua cadeia de caracteres da mensagem definida como message, o HRESULT definido como COR_E_IO e a exceção interna definida como null.
IOException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe IOException com as informações de serialização e contexto especificadas.
IOException(String, Exception)	Inicializa uma nova instância da classe IOException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.
IOException(String, Int32)	Inicializa uma nova instância da classe IOException com sua cadeia de caracteres de mensagem definida para message e seu HRESULT definido pelo usuário.

IOException()

Origem:

IOException.cs

Inicializa uma nova instância da classe IOException com sua cadeia de caracteres de mensagem definida como a cadeia de caracteres vazia (""), o HRESULT é definido como COR_E_IO e sua exceção interna é definida como uma referência nula.

public:
 IOException();

public IOException ();

Public Sub New ()

Comentários

O construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "Ocorreu um erro de E/S ao executar a operação solicitada". Essa mensagem leva em conta a cultura atual do sistema.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

IOException(String)

Origem:

IOException.cs

Inicializa uma nova instância da classe IOException com sua cadeia de caracteres da mensagem definida como message, o HRESULT definido como COR_E_IO e a exceção interna definida como null.

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

public IOException (string? message);

new System.IO.IOException : string -> System.IO.IOException

Public Sub New (message As String)

Parâmetros

message

String

Um String que descreve o erro. O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

Comentários

O construtor inicializa a Message propriedade da nova instância usando message.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

IOException(SerializationInfo, StreamingContext)

Origem:

IOException.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 IOException com as informações de serialização e contexto especificadas.

protected:
 IOException(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 IOException (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 System.IO.IOException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.IO.IOException

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

Parâmetros

info

SerializationInfo

Os dados para serializar ou desserializar o objeto.

context

StreamingContext

A origem e destino para o objeto.

Atributos

ObsoleteAttribute

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

IOException(String, Exception)

Origem:

IOException.cs

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

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

public IOException (string? message, Exception? innerException);

new System.IO.IOException : string * Exception -> System.IO.IOException

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

Parâmetros

message

String

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

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.

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 IOException.

Propriedade	Valor
InnerException	A referência de exceção interna.
Message	A cadeia de caracteres da mensagem de erro.

Para obter mais informações sobre exceções internas, consulte InnerException.

Confira também

• Exception
• Tratando e gerando exceções no .NET
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

IOException(String, Int32)

Origem:

IOException.cs

Inicializa uma nova instância da classe IOException com sua cadeia de caracteres de mensagem definida para message e seu HRESULT definido pelo usuário.

public:
 IOException(System::String ^ message, int hresult);

public IOException (string? message, int hresult);

new System.IO.IOException : string * int -> System.IO.IOException

Public Sub New (message As String, hresult As Integer)

Parâmetros

message

String

Um String que descreve o erro. O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

hresult

Int32

Um inteiro que identifica o erro que ocorreu.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo