CookieException CookieException CookieException CookieException Class

定义

CookieContainer 添加 Cookie 出错时引发的异常。The exception that is thrown when an error is made adding a Cookie to a CookieContainer.

public ref class CookieException : FormatException
[System.Serializable]
public class CookieException : FormatException
type CookieException = class
    inherit FormatException
    interface ISerializable
Public Class CookieException
Inherits FormatException
继承
属性
实现

注解

Add如果尝试CookieMaxCookieSize长度大于到, 则会引发此异常。 CookieContainerThis exception is thrown if an attempt is made to Add a Cookie with length greater than MaxCookieSize to a CookieContainer.

相关提示Associated Tips

请确保 cookie 大小不会超出 cookie 容器所允许的最大值。Make sure the cookie size does not exceed the maximum allowed by the cookie container.
当尝试向 Cookie 中添加一个长度大于 MaxCookieSizeCookieContainer 时会引发此异常。This exception is thrown when an attempt is made to add a Cookie with length greater than MaxCookieSize to a CookieContainer. 默认的最大 Cookie 大小为 4096 字节。The default maximum cookie size is 4096 bytes.

为 cookie 设置 Name 属性时, 请确保该值不是 null 引用或空字符串。When setting the Name property for a cookie, make sure the value is not a null reference or empty string.
在使用 Name 类的实例之前必须初始化 Cookie 属性。The Name property must be initialized before using an instance of the Cookie class. 以下字符是保留的并且不能用于此特性值:等号、分号、逗号、换行符 (\n)、回车符 (\r)、制表符 (\t)。The following characters are reserved and cannot be used for this attribute value: equal sign, semicolon, comma, new line (\n), carriage return (\r), tab (\t). 货币符号 ($) 不能作为第一个字符。The dollar sign ($) character cannot be the first character.

为 cookie 设置 Port 属性时, 请确保该值有效并括在双引号中。When setting the Port property for a cookie, make sure the value is valid and enclosed in double quotes.
Port 特性限制可以将 Cookie 发送到的端口。The Port attribute restricts the ports to which a cookie may be sent. 默认值表示没有限制。The default value means no restriction. 设置该属性为空字符串 ("") 会将端口限制为在 HTTP 响应中使用的端口。Setting the property to an empty string ("") restricts the port to the one used in the HTTP response. 否则该值必须是一个用引号括起来的字符串,其中包含以逗号分隔的端口值。Otherwise the value must be a string in quotation marks that contains port values delineated with commas.

为 cookie 设置 Value 属性时, 请确保该值不为 null。When setting the Value property for a cookie, make sure the value is not null.
以下字符是保留的并且不能用于此属性:分号、逗号。The following characters are reserved and cannot be used for this property: semicolon, comma.

构造函数

CookieException() CookieException() CookieException() CookieException()

初始化 CookieException 类的新实例。Initializes a new instance of the CookieException class.

CookieException(SerializationInfo, StreamingContext) CookieException(SerializationInfo, StreamingContext) CookieException(SerializationInfo, StreamingContext) CookieException(SerializationInfo, StreamingContext)

使用 serializationInfostreamingContext 的特定值初始化 CookieException 类的新实例。Initializes a new instance of the CookieException class with specific values of serializationInfo and streamingContext.

方法

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

当在派生类中重写时,返回 Exception,它是一个或多个并发的异常的根源。When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

用序列化 SerializationInfo 所需的数据填充 CookieException 实例。Populates a SerializationInfo instance with the data needed to serialize the CookieException.

GetType() GetType() GetType() GetType()

获取当前实例的运行时类型。Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

创建并返回当前异常的字符串表示形式。Creates and returns a string representation of the current exception.

(Inherited from Exception)

显式界面实现

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

用序列化 SerializationInfo 所需的数据填充 CookieException 实例。Populates a SerializationInfo instance with the data needed to serialize the CookieException.

属性

Data Data Data Data

获取提供有关异常的其他用户定义信息的键/值对集合。Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

获取或设置指向与此异常关联的帮助文件链接。Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

获取或设置 HRESULT(一个分配给特定异常的编码数字值)。Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

获取导致当前异常的 Exception 实例。Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

获取描述当前异常的消息。Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

获取或设置导致错误的应用程序或对象的名称。Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

获取调用堆栈上的即时框架字符串表示形式。Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

获取引发当前异常的方法。Gets the method that throws the current exception.

(Inherited from Exception)

事件

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

适用于

另请参阅