IOException Classe

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

IOException.cs

A exceção que é gerada quando ocorre um erro de E/S.

C#

public class IOException : SystemException

Herança

Object

Exception

SystemException

IOException

Derivado

System.IO.DirectoryNotFoundException

System.IO.DriveNotFoundException

System.IO.EndOfStreamException

System.IO.FileLoadException

System.IO.FileNotFoundException

System.IO.PathTooLongException

System.IO.PipeException

System.Net.Http.HttpIOException

System.Net.Quic.QuicException

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para o FileStream.Lock método .

C#

// Catch the IOException generated if the
// specified part of the file is locked.
catch(IOException e)
{
    Console.WriteLine(
        "{0}: The write operation could not " +
        "be performed because the specified " +
        "part of the file is locked.",
        e.GetType().Name);
}

Comentários

IOException é a classe base para exceções geradas ao acessar informações usando fluxos, arquivos e diretórios.

A Biblioteca de Classes Base inclui os seguintes tipos, cada um dos quais é uma classe derivada de IOException :

• DirectoryNotFoundException

• EndOfStreamException

• FileNotFoundException

• FileLoadException

• PathTooLongException

Quando apropriado, use esses tipos em vez de IOException.

IOException usa o COR_E_IO HRESULT que tem o valor 0x80131620.

Construtores

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(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe IOException com as informações de serialização e contexto especificadas.
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(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.

Propriedades

Data	Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception)
HelpLink	Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception)
HResult	Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância Exception que causou a exceção atual. (Herdado de Exception)
Message	Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception)
Source	Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção. (Herdado de Exception)
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception)

Eventos

SerializeObjectState

Obsoleto. Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception)

Aplica-se a

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