OperationCanceledException 构造函数

定义

初始化 OperationCanceledException 类的新实例。

重载

OperationCanceledException()

使用系统提供的错误信息初始化 OperationCanceledException 类的新实例。

OperationCanceledException(String)

用指定的错误消息初始化 OperationCanceledException 类的新实例。

OperationCanceledException(CancellationToken)

用取消令牌初始化 OperationCanceledException 类的新实例。

OperationCanceledException(SerializationInfo, StreamingContext)
已过时.

用序列化数据初始化 OperationCanceledException 类的新实例。

OperationCanceledException(String, Exception)

使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 OperationCanceledException 类的新实例。

OperationCanceledException(String, CancellationToken)

使用指定的错误信息和取消令牌初始化 OperationCanceledException 类的新实例。

OperationCanceledException(String, Exception, CancellationToken)

使用指定的错误消息、对作为此异常原因的内部异常的引用以及取消标记来初始化 OperationCanceledException 类的新实例。

OperationCanceledException()

使用系统提供的错误信息初始化 OperationCanceledException 类的新实例。

public:
 OperationCanceledException();
public OperationCanceledException ();
Public Sub New ()

注解

此构造函数将 Message 新实例的 属性初始化为描述错误的系统提供的消息,例如“操作已取消”。此消息考虑了当前系统区域性。

下表显示了 OperationCanceledException 实例的初始属性值。

properties Value
InnerException Visual Basic) Nothing 中的 nullreference (。
Message 本地化的错误消息字符串。
CancellationToken 在非取消状态下创建的取消令牌。

另请参阅

适用于

OperationCanceledException(String)

用指定的错误消息初始化 OperationCanceledException 类的新实例。

public:
 OperationCanceledException(System::String ^ message);
public OperationCanceledException (string message);
public OperationCanceledException (string? message);
new OperationCanceledException : string -> OperationCanceledException
Public Sub New (message As String)

参数

message
String

描述该错误的 String

注解

message 的内容设计为易于理解。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

下表显示了 OperationCanceledException 实例的初始属性值。

properties
InnerException 空引用(在 Visual Basic 中为 Nothing)。
Message 错误消息字符串。
CancellationToken 在非取消状态下创建的取消令牌。

另请参阅

适用于

OperationCanceledException(CancellationToken)

用取消令牌初始化 OperationCanceledException 类的新实例。

public:
 OperationCanceledException(System::Threading::CancellationToken token);
public OperationCanceledException (System.Threading.CancellationToken token);
new OperationCanceledException : System.Threading.CancellationToken -> OperationCanceledException
Public Sub New (token As CancellationToken)

参数

token
CancellationToken

与已取消的操作关联的取消标记。

注解

此构造函数将 Message 新实例的 属性初始化为描述错误的系统提供的消息,例如“操作已取消”。此消息考虑了当前系统区域性。

下表显示了 OperationCanceledException 实例的初始属性值。

properties Value
InnerException Visual Basic) Nothing 中的 nullreference (。
Message 本地化的错误消息字符串。
CancellationToken token.

另请参阅

适用于

OperationCanceledException(SerializationInfo, StreamingContext)

注意

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

用序列化数据初始化 OperationCanceledException 类的新实例。

protected:
 OperationCanceledException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected OperationCanceledException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected OperationCanceledException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new OperationCanceledException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> OperationCanceledException
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new OperationCanceledException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> OperationCanceledException
Protected Sub New (info As SerializationInfo, context As StreamingContext)

参数

info
SerializationInfo

承载序列化对象数据的对象。

context
StreamingContext

关于来源和目标的上下文信息

属性

注解

在反序列化期间调用此构造函数以重新构造在流上传输的异常对象。 有关详细信息,请参阅 XML 和 SOAP 序列化

另请参阅

适用于

OperationCanceledException(String, Exception)

使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 OperationCanceledException 类的新实例。

public:
 OperationCanceledException(System::String ^ message, Exception ^ innerException);
public OperationCanceledException (string message, Exception innerException);
public OperationCanceledException (string? message, Exception? innerException);
new OperationCanceledException : string * Exception -> OperationCanceledException
Public Sub New (message As String, innerException As Exception)

参数

message
String

解释异常原因的错误消息。

innerException
Exception

导致当前异常的异常。 如果 innerException 参数不为 null,则当前异常将在处理内部异常的 catch 块中引发。

注解

message 的内容设计为易于理解。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

因前一个异常而直接引发的异常应在 InnerException 属性中包含对前一个异常的引用。 InnerException 属性将返回传递给构造函数的同一值;如果 InnerException 属性不向构造函数提供内部异常值,则返回 null

下表显示了 OperationCanceledException 实例的初始属性值。

属性类型 条件
InnerException innerException.
Message message.
CancellationToken 在非取消状态下创建的取消令牌。

另请参阅

适用于

OperationCanceledException(String, CancellationToken)

使用指定的错误信息和取消令牌初始化 OperationCanceledException 类的新实例。

public:
 OperationCanceledException(System::String ^ message, System::Threading::CancellationToken token);
public OperationCanceledException (string message, System.Threading.CancellationToken token);
public OperationCanceledException (string? message, System.Threading.CancellationToken token);
new OperationCanceledException : string * System.Threading.CancellationToken -> OperationCanceledException
Public Sub New (message As String, token As CancellationToken)

参数

message
String

解释异常原因的错误消息。

token
CancellationToken

与已取消的操作关联的取消标记。

注解

message 的内容设计为易于理解。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

下表显示了 OperationCanceledException 实例的初始属性值。

properties
InnerException 空引用(在 Visual Basic 中为 Nothing)。
Message message.
CancellationToken token.

另请参阅

适用于

OperationCanceledException(String, Exception, CancellationToken)

使用指定的错误消息、对作为此异常原因的内部异常的引用以及取消标记来初始化 OperationCanceledException 类的新实例。

public:
 OperationCanceledException(System::String ^ message, Exception ^ innerException, System::Threading::CancellationToken token);
public OperationCanceledException (string message, Exception innerException, System.Threading.CancellationToken token);
public OperationCanceledException (string? message, Exception? innerException, System.Threading.CancellationToken token);
new OperationCanceledException : string * Exception * System.Threading.CancellationToken -> OperationCanceledException
Public Sub New (message As String, innerException As Exception, token As CancellationToken)

参数

message
String

解释异常原因的错误消息。

innerException
Exception

导致当前异常的异常。 如果 innerException 参数不为 null,则当前异常将在处理内部异常的 catch 块中引发。

token
CancellationToken

与已取消的操作关联的取消标记。

注解

message 的内容设计为易于理解。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

因前一个异常而直接引发的异常应在 InnerException 属性中包含对前一个异常的引用。 InnerException 属性将返回传递给构造函数的同一值;如果 InnerException 属性不向构造函数提供内部异常值,则返回 null

下表显示了 OperationCanceledException 实例的初始属性值。

属性类型 条件
InnerException innerException.
Message message.
CancellationToken token.

另请参阅

适用于