FaultException<TDetail> Constructeurs

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Initialise une nouvelle instance de la classe FaultException<TDetail>.

Surcharges

FaultException<TDetail>(TDetail)	Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail spécifié.
FaultException<TDetail>(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe FaultException<TDetail> à l'aide des informations de sérialisation spécifiées et du contexte lors de la désérialisation d'un flux en objet FaultException.
FaultException<TDetail>(TDetail, FaultReason)	Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail et la raison de l'erreur spécifiés.
FaultException<TDetail>(TDetail, String)	Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise le détail et la raison de l'erreur spécifiés.
FaultException<TDetail>(TDetail, FaultReason, FaultCode)	Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail, la raison de l'erreur et le code d'erreur spécifiés.
FaultException<TDetail>(TDetail, String, FaultCode)	Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail, la raison de l'erreur et le code d'erreur spécifiés.
FaultException<TDetail>(TDetail, FaultReason, FaultCode, String)	Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail spécifié et les valeurs de la raison de l'erreur SOAP, du code et de l'action.
FaultException<TDetail>(TDetail, String, FaultCode, String)	Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail spécifié et les valeurs de la raison de l'erreur SOAP, du code et de l'action.

FaultException<TDetail>(TDetail)

Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail spécifié.

public:
 FaultException(TDetail detail);

public FaultException (TDetail detail);

new System.ServiceModel.FaultException<'Detail> : 'Detail -> System.ServiceModel.FaultException<'Detail>

Public Sub New (detail As TDetail)

Paramètres

detail

TDetail

Objet utilisé comme détail d'erreur SOAP.

Exemples

L'exemple de code suivant montre comment un service utilise le type d'FaultException<TDetail> pour lever une exception gérée qui est convertie en erreur SOAP spécifiée par l'FaultContractAttribute.

using System;
using System.Collections.Generic;
using System.Net.Security;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Text;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(Namespace="http://microsoft.wcf.documentation")]
  public interface ISampleService{
    [OperationContract]
    [FaultContractAttribute(
      typeof(GreetingFault),
      Action="http://www.contoso.com/GreetingFault",
      ProtectionLevel=ProtectionLevel.EncryptAndSign
      )]
    string SampleMethod(string msg);
  }

  [DataContractAttribute]
  public class GreetingFault
  {
    private string report;

    public GreetingFault(string message)
    {
      this.report = message;
    }

    [DataMemberAttribute]
    public string Message
    {
      get { return this.report; }
      set { this.report = value; }
    }
  }

  class SampleService : ISampleService
  {
  #region ISampleService Members

  public string  SampleMethod(string msg)
  {
    Console.WriteLine("Client said: " + msg);
    // Generate intermittent error behavior.
    Random rnd = new Random(DateTime.Now.Millisecond);
    int test = rnd.Next(5);
    if (test % 2 != 0)
      return "The service greets you: " + msg;
    else
      throw new FaultException<GreetingFault>(new GreetingFault("A Greeting error occurred. You said: " + msg));
  }

  #endregion
  }
}

Imports System.Collections.Generic
Imports System.Net.Security
Imports System.Runtime.Serialization
Imports System.ServiceModel
Imports System.Text

Namespace Microsoft.WCF.Documentation
  <ServiceContract(Namespace:="http://microsoft.wcf.documentation")> _
  Public Interface ISampleService
    <OperationContract, FaultContractAttribute(GetType(GreetingFault), Action:="http://www.contoso.com/GreetingFault", ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
    Function SampleMethod(ByVal msg As String) As String
  End Interface

  <DataContractAttribute> _
  Public Class GreetingFault
    Private report As String

    Public Sub New(ByVal message As String)
      Me.report = message
    End Sub

    <DataMemberAttribute> _
    Public Property Message() As String
      Get
          Return Me.report
      End Get
      Set(ByVal value As String)
          Me.report = value
      End Set
    End Property
  End Class

  Friend Class SampleService
      Implements ISampleService
  #Region "ISampleService Members"

  Public Function SampleMethod(ByVal msg As String) As String Implements ISampleService.SampleMethod
    Console.WriteLine("Client said: " & msg)
    ' Generate intermittent error behavior.
    Dim rand As New Random(DateTime.Now.Millisecond)
    Dim test As Integer = rand.Next(5)
    If test Mod 2 <> 0 Then
      Return "The service greets you: " & msg
    Else
      Throw New FaultException(Of GreetingFault)(New GreetingFault("A Greeting error occurred. You said: " & msg))
    End If
  End Function

  #End Region
  End Class
End Namespace

Remarques

L'objet de détail doit être sérialisable ou une exception est levée lorsque FaultException<TDetail> est sérialisé.

FaultException<TDetail>(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe FaultException<TDetail> à l'aide des informations de sérialisation spécifiées et du contexte lors de la désérialisation d'un flux en objet FaultException.

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

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

new System.ServiceModel.FaultException<'Detail> : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.ServiceModel.FaultException<'Detail>

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

Paramètres

info

SerializationInfo

Informations de sérialisation nécessaires à la reconstruction de l'objet FaultException à partir du context.

context

StreamingContext

Flux à partir duquel reconstruire l'objet FaultException.

FaultException<TDetail>(TDetail, FaultReason)

Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail et la raison de l'erreur spécifiés.

public:
 FaultException(TDetail detail, System::ServiceModel::FaultReason ^ reason);

public FaultException (TDetail detail, System.ServiceModel.FaultReason reason);

new System.ServiceModel.FaultException<'Detail> : 'Detail * System.ServiceModel.FaultReason -> System.ServiceModel.FaultException<'Detail>

Public Sub New (detail As TDetail, reason As FaultReason)

Paramètres

detail

TDetail

Objet utilisé comme détail d'erreur SOAP.

reason

FaultReason

Raison de l'erreur SOAP.

FaultException<TDetail>(TDetail, String)

Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise le détail et la raison de l'erreur spécifiés.

public:
 FaultException(TDetail detail, System::String ^ reason);

public FaultException (TDetail detail, string reason);

new System.ServiceModel.FaultException<'Detail> : 'Detail * string -> System.ServiceModel.FaultException<'Detail>

Public Sub New (detail As TDetail, reason As String)

Paramètres

detail

TDetail

Objet utilisé comme détail d'erreur SOAP.

reason

String

Raison de l'erreur SOAP.

FaultException<TDetail>(TDetail, FaultReason, FaultCode)

Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail, la raison de l'erreur et le code d'erreur spécifiés.

public:
 FaultException(TDetail detail, System::ServiceModel::FaultReason ^ reason, System::ServiceModel::FaultCode ^ code);

public FaultException (TDetail detail, System.ServiceModel.FaultReason reason, System.ServiceModel.FaultCode code);

new System.ServiceModel.FaultException<'Detail> : 'Detail * System.ServiceModel.FaultReason * System.ServiceModel.FaultCode -> System.ServiceModel.FaultException<'Detail>

Public Sub New (detail As TDetail, reason As FaultReason, code As FaultCode)

Paramètres

detail

TDetail

Objet utilisé comme détail d'erreur SOAP.

reason

FaultReason

Raison de l'erreur SOAP.

code

FaultCode

Code d'erreur pour l'erreur SOAP.

FaultException<TDetail>(TDetail, String, FaultCode)

Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail, la raison de l'erreur et le code d'erreur spécifiés.

public:
 FaultException(TDetail detail, System::String ^ reason, System::ServiceModel::FaultCode ^ code);

public FaultException (TDetail detail, string reason, System.ServiceModel.FaultCode code);

new System.ServiceModel.FaultException<'Detail> : 'Detail * string * System.ServiceModel.FaultCode -> System.ServiceModel.FaultException<'Detail>

Public Sub New (detail As TDetail, reason As String, code As FaultCode)

Paramètres

detail

TDetail

Objet utilisé comme détail d'erreur SOAP.

reason

String

Raison de l'erreur SOAP.

code

FaultCode

Code d'erreur pour l'erreur SOAP.

FaultException<TDetail>(TDetail, FaultReason, FaultCode, String)

Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail spécifié et les valeurs de la raison de l'erreur SOAP, du code et de l'action.

public:
 FaultException(TDetail detail, System::ServiceModel::FaultReason ^ reason, System::ServiceModel::FaultCode ^ code, System::String ^ action);

public FaultException (TDetail detail, System.ServiceModel.FaultReason reason, System.ServiceModel.FaultCode code, string action);

new System.ServiceModel.FaultException<'Detail> : 'Detail * System.ServiceModel.FaultReason * System.ServiceModel.FaultCode * string -> System.ServiceModel.FaultException<'Detail>

Public Sub New (detail As TDetail, reason As FaultReason, code As FaultCode, action As String)

Paramètres

detail

TDetail

Objet utilisé comme détail d'erreur SOAP.

reason

FaultReason

Raison de l'erreur SOAP.

code

FaultCode

Code d'erreur pour l'erreur SOAP.

action

String

Action de l'erreur SOAP.

FaultException<TDetail>(TDetail, String, FaultCode, String)

Initialise une nouvelle instance de la classe FaultException<TDetail> qui utilise l'objet de détail spécifié et les valeurs de la raison de l'erreur SOAP, du code et de l'action.

public:
 FaultException(TDetail detail, System::String ^ reason, System::ServiceModel::FaultCode ^ code, System::String ^ action);

public FaultException (TDetail detail, string reason, System.ServiceModel.FaultCode code, string action);

new System.ServiceModel.FaultException<'Detail> : 'Detail * string * System.ServiceModel.FaultCode * string -> System.ServiceModel.FaultException<'Detail>

Public Sub New (detail As TDetail, reason As String, code As FaultCode, action As String)

Paramètres

detail

TDetail

Objet utilisé comme détail d'erreur SOAP.

reason

String

Raison de l'erreur SOAP.

code

FaultCode

Code d'erreur pour l'erreur SOAP.

action

String

Action de l'erreur SOAP.