FaultException<TDetail> Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe FaultException<TDetail>.
Sobrecargas
| FaultException<TDetail>(TDetail) |
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhes especificado. |
| FaultException<TDetail>(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da classe FaultException<TDetail>, usando as informações de serialização e de contexto especificadas ao desserializar um fluxo em um objeto FaultException. |
| FaultException<TDetail>(TDetail, FaultReason) |
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe e o motivo da falha especificados. |
| FaultException<TDetail>(TDetail, String) |
Inicializa uma nova instância da classe FaultException<TDetail> que usa o detalhe e o motivo da falha especificados. |
| FaultException<TDetail>(TDetail, FaultReason, FaultCode) |
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe, o motivo da falha e o código de falha especificados. |
| FaultException<TDetail>(TDetail, String, FaultCode) |
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe, o motivo da falha e o código de falha especificados. |
| FaultException<TDetail>(TDetail, FaultReason, FaultCode, String) |
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe especificado e os valores de motivo da falha SOAP, de código e de ação. |
| FaultException<TDetail>(TDetail, String, FaultCode, String) |
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe especificado e os valores de motivo da falha SOAP, de código e de ação. |
FaultException<TDetail>(TDetail)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhes especificado.
public:
FaultException(TDetail detail);public FaultException (TDetail detail);new System.ServiceModel.FaultException<'Detail> : 'Detail -> System.ServiceModel.FaultException<'Detail>Public Sub New (detail As TDetail)Parâmetros
- detail
- TDetail
O objeto usado como o detalhe de falha SOAP.
Exemplos
O exemplo de código a seguir mostra como um serviço usa o FaultException<TDetail> tipo para gerar uma exceção gerenciada que é convertida na falha SOAP especificada pelo 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
Comentários
O objeto de detalhe deve ser serializável ou uma exceção é gerada quando o FaultException<TDetail> é serializado.
Aplica-se a
FaultException<TDetail>(SerializationInfo, StreamingContext)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail>, usando as informações de serialização e de contexto especificadas ao desserializar um fluxo em um objeto 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)Parâmetros
- info
- SerializationInfo
As informações de serialização necessárias para reconstruir o objeto FaultException com base no context.
- context
- StreamingContext
O fluxo que servirá como base para reconstruir o objeto FaultException.
Aplica-se a
FaultException<TDetail>(TDetail, FaultReason)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe e o motivo da falha especificados.
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)Parâmetros
- detail
- TDetail
O objeto usado como o detalhe de falha SOAP.
- reason
- FaultReason
O motivo da falha de SOAP.
Aplica-se a
FaultException<TDetail>(TDetail, String)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail> que usa o detalhe e o motivo da falha especificados.
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)Parâmetros
- detail
- TDetail
O objeto usado como o detalhe de falha SOAP.
- reason
- String
O motivo da falha de SOAP.
Aplica-se a
FaultException<TDetail>(TDetail, FaultReason, FaultCode)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe, o motivo da falha e o código de falha especificados.
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)Parâmetros
- detail
- TDetail
O objeto usado como o detalhe de falha SOAP.
- reason
- FaultReason
O motivo da falha de SOAP.
- code
- FaultCode
O código de falha da falha de SOAP.
Aplica-se a
FaultException<TDetail>(TDetail, String, FaultCode)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe, o motivo da falha e o código de falha especificados.
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)Parâmetros
- detail
- TDetail
O objeto usado como o detalhe de falha SOAP.
- reason
- String
O motivo da falha de SOAP.
- code
- FaultCode
O código de falha da falha de SOAP.
Aplica-se a
FaultException<TDetail>(TDetail, FaultReason, FaultCode, String)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe especificado e os valores de motivo da falha SOAP, de código e de ação.
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)Parâmetros
- detail
- TDetail
O objeto usado como o detalhe de falha SOAP.
- reason
- FaultReason
O motivo da falha de SOAP.
- code
- FaultCode
O código de falha da falha de SOAP.
- action
- String
A ação da falha de SOAP.
Aplica-se a
FaultException<TDetail>(TDetail, String, FaultCode, String)
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
- Origem:
- FaultException.cs
Inicializa uma nova instância da classe FaultException<TDetail> que usa o objeto de detalhe especificado e os valores de motivo da falha SOAP, de código e de ação.
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)Parâmetros
- detail
- TDetail
O objeto usado como o detalhe de falha SOAP.
- reason
- String
O motivo da falha de SOAP.
- code
- FaultCode
O código de falha da falha de SOAP.
- action
- String
A ação da falha de SOAP.
