CookieException 类

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

Source:

CookieException.cs

向 CookieContainer 添加 Cookie 出错时引发的异常。

public ref class CookieException : FormatException

public class CookieException : FormatException

type CookieException = class
    inherit FormatException
    interface ISerializable

Public Class CookieException
Inherits FormatException

继承

Object

Exception

SystemException

FormatException

CookieException

实现

ISerializable

注解

如果尝试AddCookie对长度大于 MaxCookieSizeCookieContainer的 ，则会引发此异常。

相关提示

确保 Cookie 大小不会超出 Cookie 容器所允许的最大值。 当尝试向 Cookie 中添加一个长度大于 MaxCookieSize 的 CookieContainer 时会引发此异常。 默认的最大 Cookie 大小为 4096 字节。

当为一个 Cookie 设置 Name 属性时，应确保该值不是 null 引用或空字符串。 在使用 Name 类的实例之前必须初始化 Cookie 属性。 以下字符是保留的并且不能用于此特性值：等号、分号、逗号、换行符 (\n)、回车符 (\r)、制表符 (\t)。 货币符号 ($) 不能作为第一个字符。

当为 Cookie 设置 Port 属性时，应确保该值有效并括在双引号中。 Port 特性限制可以将 Cookie 发送到的端口。 默认值表示没有限制。 设置该属性为空字符串 ("") 会将端口限制为在 HTTP 响应中使用的端口。 否则该值必须是一个用引号括起来的字符串，其中包含以逗号分隔的端口值。

当为 Cookie 设置 Value 属性时，应确保该值不为 null。 以下字符是保留的并且不能用于此属性：分号、逗号。

构造函数

CookieException()	初始化 CookieException 类的新实例。
CookieException(SerializationInfo, StreamingContext)	已过时. 使用 serializationInfo 和 streamingContext 的特定值初始化 CookieException 类的新实例。

属性

Data	获取键/值对的集合，这些键/值对提供有关该异常的其他用户定义信息。 (继承自 Exception)
HelpLink	获取或设置指向与此异常关联的帮助文件链接。 (继承自 Exception)
HResult	获取或设置 HRESULT（一个分配给特定异常的编码数字值）。 (继承自 Exception)
InnerException	获取导致当前异常的 Exception 实例。 (继承自 Exception)
Message	获取描述当前异常的消息。 (继承自 Exception)
Source	获取或设置导致错误的应用程序或对象的名称。 (继承自 Exception)
StackTrace	获取调用堆栈上的即时框架字符串表示形式。 (继承自 Exception)
TargetSite	获取引发当前异常的方法。 (继承自 Exception)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetBaseException()	当在派生类中重写时，返回 Exception，它是一个或多个并发的异常的根本原因。 (继承自 Exception)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)	已过时. 用序列化 SerializationInfo 所需的数据填充 CookieException 实例。
GetType()	获取当前实例的运行时类型。 (继承自 Exception)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	创建并返回当前异常的字符串表示形式。 (继承自 Exception)

事件

SerializeObjectState

已过时. 当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。 (继承自 Exception)

显式接口实现

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

用序列化 SerializationInfo 所需的数据填充 CookieException 实例。

另请参阅

• ISerializable