InstallException Construtores

Definição

Namespace:

System.Configuration.Install

Assembly:

System.Configuration.Install.dll

Inicializa uma nova instância da classe InstallException.

Sobrecargas

InstallException()	Inicializa uma nova instância da classe InstallException.
InstallException(String)	Inicializa uma nova instância da classe InstallException e especifica a mensagem a ser exibida ao usuário.
InstallException(SerializationInfo, StreamingContext)	Inicializa uma nova instância da classe InstallException com dados serializados.
InstallException(String, Exception)	Inicializa uma nova instância da classe InstallException e especifica a mensagem a ser exibida ao usuário e uma referência à exceção interna que é a causa dessa exceção.

InstallException()

Inicializa uma nova instância da classe InstallException.

public:
 InstallException();

public InstallException ();

Public Sub New ()

Exemplos

O exemplo a seguir demonstra o InstallException construtor . Ele faz parte do exemplo da InstallException classe .

Neste exemplo, Installutil.exe chama o Commit método . O código em Commit presume que exista um arquivo chamado FileDoesNotExist.txt antes que a instalação do assembly possa ser confirmada. Se o arquivo FileDoesNotExist.txt não existir, Commit gerará um InstallException.

Observação

Este exemplo mostra como usar uma das versões sobrecarregadas do InstallException construtor. Para obter outros exemplos que possam estar disponíveis, consulte os tópicos de sobrecarga individuais.

virtual void Commit( IDictionary^ savedState ) override
{
   Installer::Commit( savedState );
   Console::WriteLine( "Commit ..." );
   
   // Throw an error if a particular file doesn't exist.
   if (  !File::Exists( "FileDoesNotExist.txt" ) )
         throw gcnew InstallException;

   
   // Perform the final installation if the file exists.
}

public override void Commit(IDictionary savedState)
{
   base.Commit(savedState);
   Console.WriteLine("Commit ...");
   // Throw an error if a particular file doesn't exist.
   if(!File.Exists("FileDoesNotExist.txt"))
      throw new InstallException();
   // Perform the final installation if the file exists.
}

Public Overrides Sub Commit(savedState As IDictionary)
   MyBase.Commit(savedState)
   Console.WriteLine("Commit ...")
   ' Throw an error if a particular file doesn't exist.
   If Not File.Exists("FileDoesNotExist.txt") Then
      Throw New InstallException()
   End If
   ' Perform the final installation if the file exists.
End Sub

InstallException(String)

Inicializa uma nova instância da classe InstallException e especifica a mensagem a ser exibida ao usuário.

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

public InstallException (string message);

new System.Configuration.Install.InstallException : string -> System.Configuration.Install.InstallException

Public Sub New (message As String)

Parâmetros

message

String

A mensagem a ser exibida ao usuário.

Exemplos

O exemplo a seguir demonstra o InstallException construtor . Ele faz parte do exemplo da InstallException classe .

Neste exemplo, Installutil.exe chama o Uninstall método . A desinstalação só ocorrerá se existir um arquivo chamado FileDoesNotExist.txt . Caso contrário, ele gerará um InstallException.

Observação

Este exemplo mostra como usar uma das versões sobrecarregadas do InstallException construtor. Para obter outros exemplos que possam estar disponíveis, consulte os tópicos de sobrecarga individuais.

virtual void Uninstall( IDictionary^ savedState ) override
{
   Installer::Uninstall( savedState );
   Console::WriteLine( "UnInstall ..." );
   
   // Throw an error if a particular file doesn't exist.
   if (  !File::Exists( "FileDoesNotExist.txt" ) )
         throw gcnew InstallException( "The file 'FileDoesNotExist'  does not exist" );

   
   // Perform the uninstall activites if the file exists.
}

public override void Uninstall(IDictionary savedState)
{
   base.Uninstall(savedState);
   Console.WriteLine("UnInstall ...");
   // Throw an error if a particular file doesn't exist.
   if(!File.Exists("FileDoesNotExist.txt"))
      throw new InstallException("The file 'FileDoesNotExist'" +
         " does not exist");
   // Perform the uninstall activites if the file exists.
}

Public Overrides Sub Uninstall(savedState As IDictionary)
   MyBase.Uninstall(savedState)
   Console.WriteLine("UnInstall ...")
   ' Throw an error if a particular file doesn't exist.
   If Not File.Exists("FileDoesNotExist.txt") Then
      Throw New InstallException("The file 'FileDoesNotExist'" + " does not exist")
   End If
   ' Perform the uninstall activites if the file exists.
End Sub

InstallException(SerializationInfo, StreamingContext)

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

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

protected InstallException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.Configuration.Install.InstallException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Configuration.Install.InstallException

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

Parâmetros

info

SerializationInfo

O SerializationInfo que mantém os dados de objeto serializados sobre a exceção que está sendo lançada.

context

StreamingContext

O StreamingContext que contém informações contextuais sobre a fonte ou o destino.

InstallException(String, Exception)

Inicializa uma nova instância da classe InstallException e especifica a mensagem a ser exibida ao usuário e uma referência à exceção interna que é a causa dessa exceção.

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

public InstallException (string message, Exception innerException);

new System.Configuration.Install.InstallException : string * Exception -> System.Configuration.Install.InstallException

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

Parâmetros

message

String

A mensagem a ser exibida ao usuário.

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.