IOException Classe

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Source:

IOException.cs

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

public ref class IOException : SystemException

public class IOException : SystemException

type IOException = class
    inherit SystemException

Public Class IOException
Inherits 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 .

// 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 );
}

// 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);
}

' Catch the IOException generated if the 
' specified part of the file is locked.
Catch ex As IOException
    Console.WriteLine( _
        "{0}: The write operation could " & _
        "not be performed because the " & _
        "specified part of the file is " & _
        "locked.", ex.GetType().Name)
End Try

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 a 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)

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